home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / rbbs / rbtch180.zip / WHATISA.DOZ < prev    next >
Text File  |  1992-08-16  |  5KB  |  152 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                        -------------------
  14.                        What is a .DOZ File
  15.                        -------------------
  16.  
  17.  
  18.  
  19.                    .DOZ File Internal Structure
  20.                      (C) by Dan Shore - 1992
  21.                         THE SHORELINE BBS
  22.                           June 12, 1992
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. A.  Why the .DOZ file was created:
  40.  
  41.  
  42. 1.  For files that do not have the ability to accept a FILE_ID.DIZ
  43.     or a DESC.SDI.  What types of files are these do you ask?  Well,
  44.     any file that cannot accept another file "inside" of a file
  45.     (.GIF's are an excellent example).  Remember that the .DIZ or
  46.     .SDI are just text files that are added into compressed files.
  47.  
  48. 2.  When a .DOZ file is uploaded or used locally, with descriptions
  49.     and category codes, the files uploaded are processed by RBatch
  50.     for the file description and the category code without any
  51.     intervention by the user or SysOp.  Basically AUTOMATIC UPLOADS!
  52.     As a user, just start the upload process and sit back and watch
  53.     your files posted to the BBS automatically.  As a SysOp, just run
  54.     FakeXfer, then RBatch, and again just SIT BACK AND WATCH FILES
  55.     GET POSTED TO YOUR BBS AUTOMATICALLY!!.
  56.  
  57.  
  58.  
  59. .DOZ files are VERY USEFULL when you are posting files LOCALLY
  60. to your BBS, when used in conjunction with the FakeXfer program.
  61. See the FakeXfer.Doc file for more information on this excellent
  62. new process that saves time for SysOps who post files to their BBS.
  63.  
  64.  
  65.  
  66. The .DOZ filename can be named anything as long as it is a legal
  67. DOS filename.  The internal structure of a .DOZ is as follows:
  68.  
  69.                 {FI dflat8.zip window
  70.                 Description of file goes here with a maximum
  71.                 line length of 75 characters and a maximum
  72.                 of 10 lines
  73.                 {FI ved201.zip utils
  74.                 Description of file goes here with a maximum
  75.                 line length of 75 characters and a maximum
  76.                 of 10 lines
  77.  
  78.  
  79. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Note
  80.           that there is a space between the {FI, filename, &
  81.           the category code.  Do not use a path for the file.
  82.           (The {FI is the  Smart Text variable for FileName in
  83.           RBBS, hence it seemed logical to use this as part of
  84.           the structure)
  85.  
  86.    #####  The text MUST START AT THE LEFT MARGIN.  The example
  87.           above starts in the middle of the screen for ease of
  88.           reading.
  89.  
  90.                             - 2 -
  91.  
  92.  
  93.           The category code is the code that a user would normally
  94.           type when prompted to categorize a file.  This is NOT
  95.           THE THREE DIGIT CODE in your FMS.  For example if your
  96.           DIR.CAT had this entry:
  97.  
  98.           "GAMES","GAM","All Games"
  99.  
  100.           The .DOZ entry would look like this:
  101.  
  102.           {FI WARRIORS.ZIP GAMES
  103.           This is a great graphical warrior game
  104.  
  105.  
  106. Line 2 thru 11 :  The description of the file to be posted, with
  107.                   a maximum line length of 80 chars and a maximum
  108.                   of 10 lines.
  109.  
  110.  
  111. --------------------------- IMPORTANT ------------------------------------
  112.  
  113. The .DOZ file is uploaded to a BBS as part of the Uploading process and
  114. can be sent first, in the middle, or last, it does not matter.
  115.  
  116. When using .DOZ files for local posting by the SysOp, you want your .DOZ
  117. file TO BE IN THE SAME DIRECTORY as the files that FAKEXFER is processing.
  118. After the fakexfer file is generated, the .DOZ file will be copied to the
  119. upload directory with all the other files.  If the .DOZ file is not in the
  120. upload directory, RBatch will not recognize it, hence you will be prompted
  121. for descriptions/categories.  If the file contains a FILE_ID.DIZ or a
  122. DESC.SDI then the .DOZ file description entry is ignored for that file,
  123. but the catgory code is used!
  124. --------------------------------------------------------------------------
  125.  
  126.  
  127. On the BBS side when the file is received RBatch will detect the .DOZ
  128. file and then compare the filenames in it, to the filename in the
  129. XFER-?.DEF file.  When a match is found, the description within the
  130. .DOZ is used and the user only has to categorize the upload.  If a
  131. category is found within the .DOZ file and it matches a category code
  132. on the BBS, then the user or the SysOp is not prompted to categorize as
  133. long as their security level allows them to categorize.  If the security
  134. level is too low to categorize then the default code that is specified
  135. in the configuration file is used.
  136.  
  137. ************************** AUTOMATED UPLOADS **************************
  138.  
  139. If the file being processed has a FILE_ID.DIZ or DESC.SDI and a .DOZ exists,
  140. file category codes are used from the .DOZ, and the FILE_ID.DIZ/DESC.SDI file
  141. description are used, hence the sysop/user does not have to intervene with
  142. RBatch after the upload is started from RBBS!!!!
  143.  
  144. To aid the user in this new feature, I recommend that you either post
  145. a file or make a bulletin describing how to use .DOZ files with an
  146. upload.
  147.  
  148.                                Dan Shore - SysOp
  149.                                THE SHORELINE BBS
  150.  
  151.                             - 3 -
  152.